Sage X3 Automated Test Platform- Client installer
This implementation guide covers the installation and setup required to take advantage of the Sage X3 Automated Test Platform library.
Audience
This document is for customers and partners that wish to use the Sage X3 Automated Test Platform library on their local machine.
To use Sage X3 Automated Test Platform library, you must have a Sage X3 license with the Test Robot activation parameter enabled.
What’s new
Sage X3 Automated Test Platform version 2.8.0: New installation and update process.
Sage X3 Automated Test Platform version 2.9.0:
Consult the Sage X3 Automated Test Platform - User guide for further information.
From 2025.R1 this version can't be installed anymore. You have to use a more recent version of Sage X3 Automated Test Platform compliant with your Sage X3 / Sage Warehousing product.
Sage X3 Automated Test Platform version 3.0.0:
-
Nodejs12 is required for installation or update of Sage X3 Automated Test Platform 2.X.X
-
Nodejs18. is required for installation or update of Sage X3 Automated Test Platform 3.X.X
-
To define the right version of Nodejs, refers to the following documentation: prerequisites_atp
-
From 2025.R1 this version can't be installed anymore. You have to use a more recent version of Sage X3 Automated Test Platform compliant with your Sage X3 / Sage Warehousing product.
Sage X3 Automated Test Platform 3.1.1:
-
Ensure compatibility with latest version of Nodejs 18 delivered to date.
-
Refer to the prerequisites_atp online documentation for more information. about Nodejs compatibility with Sage X3 Automated Test Platform 3.1.0
-
-
Fix issue when using Chrome version 127 to prevent search engine screen from being displayed when running tests.
From 2025.R1 this version can't be installed anymore. You have to use a more recent version of Sage X3 Automated Test Platform compliant with your Sage X3 / Sage Warehousing product.
Sage X3 Automated Test Platform 3.2.2:
-
From version 2025 R1, this version replaces previous version of Sage X3 Automated Test Platform3.2.0 / 3.2.1
-
A new ATP installer is delivered, allowing to Install or update ATP Library on your local machine without requiring a connection to Nexus repository.
-
Nodejs binary is delivered with ATP Library and doesn’t need to be installed anymore as a windows program on your locale machine.
-
To know which version of Nodejs is delivered with Sage X3 Automated Test Platform, refer to the prerequisites_atp documentation
-
- Fix issue when using Chrome version 127 to prevent search engine screen from being displayed when running tests.
Sage X3 Automated Test Platform 3.3.1:
-
From version 2025 R1, this version replaces previous version of Sage X3 Automated Test Platform3.3.0
-
A new ATP installer is delivered, allowing to Install or update ATP Library on your local machine without requiring a connection to Nexus repository.
-
Nodejs binary is delivered with ATP Library and doesn’t need to be installed anymore as a windows program on your locale machine.
-
To know which version of Nodejs is delivered with Sage X3 Automated Test Platform, refer to the prerequisites_atp documentation
-
-
Is compatible with version 17 of Java Runtime Environment (JRE). Refer to the prerequisites_atp documentation for more information about the Java Runtime Environment (JRE) compatibility.
Sage X3 Automated Test Platform 4.0.0:
-
A new ATP installer is delivered, allowing to Install or update ATP Library on your local machine without requiring a connection to Nexus repository.
-
Nodejs binary is delivered with ATP Library and doesn’t need to be installed anymore as a windows program on your locale machine.
-
To know which version of Nodejs is delivered with Sage X3 Automated Test Platform, refer to the prerequisites_atp documentation
-
For the new functionalities and new step definitions delivered with this version, refer to the Find out more chapter.
Find out more
Refer to the following guides:
Sage X3 Automated Test Platform - User guide
Sage X3 Automated Test Platform - Jenkins installation and setup
Sage X3 Automated Test Platform - Step definitions guide
Before you start
Ensure that your configuration is compatible with the recommendations described below.
Prerequisites
System requirements
The minimal system specifications required to install the Sage X3 Automated Test Platform library are listed in the table below.
| Category | Minimum configuration recommendations |
|---|---|
| Operating system |
Windows 10, 64 bit (version 1803 or higher), Windows 11, 64 bit (version 22H2 or higher) compatible from Sage X3 Automated Test Platform version 3.0.0 or higher |
| Disk | SSD (Solid State Drive) |
| Memory | 8 GB (16 GB recommended) |
| Processor | CPU (Intel® core 17, 2.4 GHZ or higher) |
Required software
The following software is required for the Sage X3 Automated Test Platform library to be able to run:
-
Web browser: Chrome version 89 or higher
-
Azul Zulu or Oracle Java
Download and install one of the following Java Runtime Environments (JRE):
-
Refer to the prerequisites_atp documentation for more information about the Java Runtime Environment (JRE)
-
Prior to installing Java and Google Chrome, please refer to the chapter Part 1: Verify the software prerequisites.
Sage X3 Automated Test Library version management
- M = Major
- m= minor
- p= Patch
You can find this version in the package.json file after installing SageX3 Automated Test Platform.
When do you need to update Sage X3 Automated Test Platform?
-
You can update Sage X3 Automated Test Platform when a new M.m.p version is released.
If you want to update the Sage X3 Automated Test Platform library, refer to the Updating to a new version chapter.
If you want to update the Jenkins pipeline, refer to the Updating your ATP-RunAutomatedTests Pipeline documentation.